すべて展開

すべて折りたたむ

Windowsアプリケーションでレポートのプレビュー表示に使用する、Viewerコントロールについて説明します。このViewerコントロールは、サムネイル、検索結果、ドキュメントマップとパラメータを含むサイドバーとツールバーを備えています。

ビューワのツールバー

ツールバー上の機能について説明します。

ツールバーのボタン	名前	解説
	サイドバー	サムネイル、パラメータ、ドキュメントマップと検索結果のペインを含むサイドバーを表示します。
	印刷	レポートの印刷を行う印刷ダイアログを表示します。
	コピー	選択モードで選択したテキストをクリップボードにコピーします。
	検索	レポート内のテキストを検索する検索ダイアログを表示します。
	縮小	レポートを縮小表示します。
	拡大	レポートを拡大表示します。
	ズーム	レポートの表示倍率を設定します。
	ページ幅	ビューワの幅に合わせてレポートの表示倍率を自動的に調整します。
	ページ全体	ページ全体が表示されるよう、レポートの表示倍率を自動的に調整します。
	単一ページ	１ページずつ表示します。
	連続ページ	連続した形式（スクロール可能な形式）で表示します。
	複数ページ	指定したページの数だけまとめて表示します。
	先頭ページ	先頭ページを表示します。
	前ページ	前のページを表示します。
	現在のページ	現在表示しているページの番号です。ページ番号を入力して、［Enter］キーを押すと、任意のページを表示します。
	次ページ	次のページを表示します。
	最終ページ	最終ページ表示します。
	戻る	前に表示していたページへ戻ります。ブラウザの［戻る］ボタンと同じ機能です。
	進む	［戻る］ボタンをクリックして戻った場合に、その前に表示していたページへ進みます。ブラウザの［進む］ボタンと同じ機能です。
	親レポートに戻る	ドリルスルーレポートの親レポートに戻ります。
	更新	レポートの表示を更新します。 注意: 以下のいずれかの方法でセクションレポートをViewerコントロールに表示した場合、［更新］ボタンが無効になります。 Documentプロパティ LoadDocument(SectionDocument)メソッド LoadDocument(String)メソッド
	パンモード	手のひらツールで画面上にナビゲートできます。
	選択モード	レポート内のコンテンツを選択できます。［コピー］アイコン（以下に画像と解説を参照）をクリックして、選択したコンテンツをクリップボードにコピーできます。
	スナップショット	レポート上のコンテンツを画像としてクリップボードにコピーします。
	キャンセル	レポートのレンダリングをキャンセルします。
	タッチモード	ビューワのタッチモードを選択できます。 メモ: ［タッチモード］ボタンは、タッチ対応デバイスのみでツールバーに表示されます。
	ゲラモード:	RDLレポートで自動で追加される改ページを削除し、データを単一ページで表示するビューワのモードです。 このモードでは、レポート上に手動で追加される改ページのみが反映されます。

ビューワのサイドバー

ツールバーでの［サイドバー］ボタンをクリックすると、ビューワサイドバーがViewerコントロールの左側に表示されます。デフォルトとして、サムネイルと検索結果のペインを表示するサイドバーにはドキュメントマップとパラメータのペインも表示できます。サイドバーの下部にある各ペインのボタンをクリックすると、ビューワのペインを変更できます。

［サムネイル］ペイン

ツールバーでの［サイドバー］ボタンをクリックすると、デフォルトでサムネイルのペインが表示されます。

このペインでは、レポート内の各ページのサムネイルが表示されます。サムネイルをクリックすることで、
レポートの対象のページが表示されます。（+）と（-）ボタンをクリックして、サムネイルのサイズを展開および縮小できます。

［検索結果］ペイン

［サイドバー］ボタンをクリックすると、デフォルトでサムネイルに加えて検索のペインもサイドバーに表示されます。このペインで、言葉または文章を入力して、レポート内に検索できます。

レポートの検索操作:

• 検索フィールドに言葉または文章を入力します。
• ［検索オプション］で、単語単位で検索するか、文字列の小文字または大文字の区別で検索するかを選択します。 
• ［検索］ボタンをクリックして、検索結果の一覧を表示します。
• リストから任意の検索項目をクリックして、レポート上に対応する項目に移動し、強調表示します。

［クリア］ボタンをクリックして、検索結果を削除できます。

［ドキュメントマップ］ペイン

［ドキュメントマップ］ペインは、Labelプロパティまたはドキュメントマップのラベルが設定されている場合、有効になります。このペインでは、ラベルするテキストボックス、グループ、サブレポートの値が表示されます。クリックすると、レポート内の対応する位置に移動します。

レポートに対して、Labelプロパティまたはドキュメントマップのラベルが設定されていない場合、［ドキュメントマップ］ペインはサイドバーに表示されません。

［パラメータ］ペイン

ビューワでは、パラメータ付きのレポートを表示できます。ツールバーでの［サイドバー］ボタンをクリックすることで、ビューワのサイドバーが開き、レポートにパラメータが存在する場合、パラメータのペインが自動的に表示されます。

1. ［パラメータ］ペインで、表示するデータをフィルターするように、ユーザーにパラメータ値の入力を求めます。
2. 値を入力または設定し、［レポートの表示］をクリックすると、レポートのデータがフィルタされます。

レポートにパラメータが設定されていない場合、パラメーターのペインはサイドバーに表示されません。

Windowsフォーム用ビューワでのレポートの表示

以下のコードは、ビューワでレポート出力を表示する方法を説明します。

1. Windowsフォームアプリケーションで、Visual Studioのツールボックスから、ActiveReportsビューワコントロールをフォーム上にドラッグします。
2. ビューワコントロールのDockプロパティをFillに設定します。
3. フォームのタイトルバーをダブルクリックしてForm_Loadイベントのハンドラを作成します。
4. レポートを実行してビューワ上に表示する次のコードをForm_Loadイベントに追加します。
   

   Visual Basic

   ページレポートまたはRDLレポートをビューワコントロール上に表示するには、次のコードを使用します。コードを実行するために、プロジェクトのBin\Debugフォルダ内にPageReport.rdlxが必要となります。

   VisualBasic（Form_Loadイベント内に貼り付けます）	コードのコピー
   Dim file_name As String = "PageReport.rdlx" Dim pageReport As New GrapeCity.ActiveReports.PageReport(New System.IO.FileInfo(file_name)) Dim pageDocument As New GrapeCity.ActiveReports.Document.PageDocument(pageReport) Viewer1.LoadDocument(pageDocument)

   セクションレポート（コードベース）をビューワコントロール上に表示するには、次のコードを使用します。コードを実行するために、プロジェクトのBin\Debugフォルダ内にセクションレポート（コードベース）が必要です。

   Visual Basic（Form_Loadイベント内に貼り付けます）YourReportNameを実際のレポート名に切り替えください。	コードのコピー
   Dim sectionReport As New YourReportName() Viewer1.LoadDocument(sectionReport)

   セクションレポート（xmlベース）をビューワコントロール上に表示するには、次のコードを使用します。コードを実行するために、プロジェクトのBin\Debugフォルダ内にreport.rpxが必要です。

   Visual Basic（Form_Loadイベント内に貼り付けます）	コードのコピー
   Dim sectionReport As New GrapeCity.ActiveReports.SectionReport() Dim xtr As New System.Xml.XmlTextReader("report.rpx") sectionReport.LoadLayout(xtr) xtr.Close() Viewer1.LoadDocument(sectionReport)

   C#

   ページレポートまたはRDLレポートをビューワコントロール上に表示するには、次のコードを使用します。コードを実行するために、プロジェクトのBin\Debugフォルダ内にPageReport.rdlxは必要です。

   C#（Form_Loadイベント内に貼り付けます）	コードのコピー
   string file_name = "PageReport.rdlx"; GrapeCity.ActiveReports.PageReport pageReport = new GrapeCity.ActiveReports.PageReport(new System.IO.FileInfo(file_name)); GrapeCity.ActiveReports.Document.PageDocument pageDocument = new GrapeCity.ActiveReports.Document.PageDocument(pageReport); viewer1.LoadDocument(pageDocument);

   セクションレポート（コードベース）をビューワコントロール上に表示するには、次のコードを使用します。コードを実行するために、プロジェクトのBin\Debugフォルダ内にセクションレポート（コードベース）が必要です。

   C#（Form_Loadイベント内に貼り付けます） YourReportNameを実際のレポート名に取り替えてください。	コードのコピー
   YourReportName sectionReport = new YourReportName(); viewer1.LoadDocument(sectionReport);

   セクションレポート（xmlベース）をビューワコントロール上に表示するには、次のコードを使用します。コードを実行するために、プロジェクトのBin\Debugフォルダ内にreport.rpxが必要です。

   C#（Form_Loadイベント内に貼り付けます）	コードのコピー
   GrapeCity.ActiveReports.SectionReport sectionReport = new GrapeCity.ActiveReports.SectionReport(); System.Xml.XmlTextReader xtr = new System.Xml.XmlTextReader("report.rpx"); sectionReport.LoadLayout(xtr); xtr.Close(); viewer1.LoadDocument(sectionReport);

その他の機能

以下、ビューワのその他の機能について説明します。

印刷の詳細設定

注釈のドロップダウン

ショートカットキー

［サムネイル］ペインのショットカットキー

タッチ対応

ActiveReportsはWindowsビューワにタッチサポートを組み込みます。この機能を利用すると、シンプルなタッチジェスチャを使用してビューワを柔軟に操作できます。これにより、ActiveReportsをWindowsのタッチ対応デバイスにインストールして、どこにいてもレポートを表示できるようになります。

タッチモードに切り替えるには、ビューワツールバーの［タッチモード］ボタンをクリックするだけです。

メモ: タッチモードでも、引き続きマウスを使用してActiveReportsを操作できます。

タッチモードのツールバー

次の表に、ビューワのツールバーから使用できる操作の一覧を示します。

アイコン	機能	詳細
	サイドバー	［サムネイル］、［パラメータ］、［ドキュメントマップ］、［検索］の各ペインを含むサイドバーを表示します。
	印刷	印刷オプションを指定できる印刷ダイアログを表示します。
	ゲラモード:	RDLレポートで自動で追加される改ページを削除し、データを単一ページで表示するビューワのモードです。 このモードでは、レポート上に手動で追加される改ページのみが反映されます。
	コピー	選択モードで選択したテキストをクリップボードにコピーします。 メモ: GrapeCity.ActiveReports.Export.Xml.v9.dllおよびGrapeCity.ActiveReports.Export.Word.v9.dllがGACから取得できない場合、ビューワの［コピー］ボタンを有効にするためにこれらのアセンブリファイルへの参照を追加しなければならないことがあります。
	検索	レポートのテキストを検索する検索ダイアログを表示します。
	ズーム	現在のズーム率を表示します。ズーム率の編集もできます。
	単一ページ	ビューワにレポートを1ページずつ表示します。
	連続ページ	すべてのプレビューページを縦に続けて表示します。
	複数ページ	ビューワで一度にプレビューするページ数を選択するオプションを提供します。
	前ページ	現在のページの前のページに移動します。このボタンは、1ページ目以外のページが開いているときに有効になります。
	現在のページ	レポートの特定のページを開きます。特定のページを表示するには、ページ番号を入力して［Enter］キーを押します。
	次ページ	現在のページの次のページに移動します。このボタンは、レポートの最後のページに達すると無効になります。
	親レポートに戻る	ドリルスルーレポートから親レポートに戻ります。
	更新	ビューワを更新します。 注意: ［更新］ボタンは、以下のいずれかによってセクションレポートをビューワコントロールにロードしたときには無効になります。 Documentプロパティ LoadDocument(SectionDocument)メソッド LoadDocument(String)メソッド
	キャンセル	レポートのレンダリングをキャンセルします。
	タッチモード	ビューワのタッチモードを選択できます。

 

コンテキストメニュー

コンテキストメニューを表示するには、プレビュー領域でタップ アンド ホールドする必要があります。

アイコン	機能	ジェスチャ	詳細
	パンモード	タップ	手のひらツールを使用してレポートの表示部分を移動できます。レポートを移動したい方向に手のひらツールをドラッグします。
	選択モード	タップ	レポートの内容を選択できます。［コピー］アイコン（上記の画像と説明を参照）をクリックすると、選択した内容がクリップボードにコピーされます。
	スナップショット	タップ	画像として別のアプリケーションに貼り付けるレポートの内容を選択できます。選択した内容は、画像の貼り付けが可能な任意のアプリケーションに貼り付けることができます。

プレビュー

ジェスチャ	ジェスチャ(画像)	プレビュー領域の要素	詳細
フリック		単一ページ	縦または横方向にフリックすると、次のページまたは前のページに移動します。1回のフリックで1ページ移動します。
		連続ページ	ページがスクロールします。
タップ		リンク	リンク（URL、ドリルスルーリンクなど）を開きます。
パン		スライダー	スライダーを動かします。
		サイドバーとプレビュー領域の境界	境界を移動します。 メモ：パンのジェスチャは、ScrollbarEnabledプロパティがFalseに設定されているレポート領域では動作しません。
		選択モード、スナップショット	選択の始点から終点にパンします。
ピンチ		プレビュー領域	縮小します。
ストレッチ		プレビュー領域	拡大します。
ダブルタップ		プレビュー領域	2回タップして、表示モードを（単一ページモードから複数ページモードに）変更します。
タップ アンド ホールド		選択モード、スナップショット	パンモード、選択モード、またはスナップショットを選択できるコンテキストメニューを表示します。

©2003-2015 GrapeCity inc. All rights reserved.